web3agent exposes over 100 tools through the MCP protocol. AI agents discover these tools automatically when the server starts. Each tool has a riskLevel that indicates its potential impact:
safe — read-only, no funds at riskfinancial — moves funds or signs transactionsdestructive — irreversible or high-impact operations
Tools marked financial or destructive go through the confirmation queue when CONFIRM_WRITES=true.
Wallet
Tools for generating and managing EVM wallets within the server.
| Tool | Risk | Description |
|---|
wallet_generate | financial | Generate a new random wallet and store it locally |
wallet_activate | financial | Set a wallet as the active signer for write operations |
wallet_deactivate | safe | Remove the active wallet (stops signing) |
wallet_derive | financial | Derive a child wallet from the active mnemonic at a given HD path |
wallet_get_address | safe | Return the address of the currently active wallet |
wallet_get_balance | safe | Get native token balance of the active wallet |
wallet_export | destructive | Export the active wallet's private key (use with caution) |
wallet_import | financial | Import an existing private key or mnemonic |
Orbs
Tools for Orbs Protocol integrations: Liquidity Hub aggregated swaps, dTWAP, dLIMIT, and Spot orders.
| Tool | Risk | Description |
|---|
orbs_get_quote | safe | Get a swap quote from Orbs Liquidity Hub |
orbs_swap | financial | Execute a same-chain swap via Orbs Liquidity Hub |
orbs_prepare_swap_intent | safe | Prepare EIP-712 swap intent data for browser-wallet signing |
orbs_prepare_twap_intent | safe | Prepare a dTWAP order intent (time-weighted average price) |
orbs_prepare_limit_intent | safe | Prepare a dLIMIT order intent (execute at target price) |
orbs_prepare_order_intent | safe | Prepare a generic Spot order intent (stop-loss, take-profit) |
orbs_prepare_bridge_intent | safe | Prepare a cross-chain bridge intent via LI.FI |
orbs_submit_signed_swap | financial | Submit a user-signed swap to the Orbs relay |
orbs_submit_signed_order | financial | Submit a user-signed Spot order to the Orbs relay |
orbs_poll_swap_status | safe | Poll the Orbs relay for swap execution status |
orbs_get_required_approvals | safe | Check which token approvals are needed before a swap or order |
orbs_list_orders | safe | List open Spot orders for an address |
orbs_place_order | financial | Place a new Spot order directly |
orbs_cancel_order | financial | Cancel an open Spot order on-chain |
orbs_get_swap_history | safe | Retrieve historical swap records for an address |
LI.FI
Tools for cross-chain bridging and swaps via the LI.FI aggregator.
| Tool | Risk | Description |
|---|
lifi_get_quote | safe | Get a bridge or cross-chain swap quote |
lifi_execute_bridge | financial | Execute a bridge transaction |
lifi_prepare_bridge_intent | safe | Prepare bridge intent data for external signing |
Explorer (Blockscout)
Indexed blockchain data tools. Available on 8 chains: Ethereum, Base, Arbitrum, Optimism, Polygon, Gnosis, Scroll, zkSync Era.
| Tool | Risk | Description |
|---|
blockscout_get_address_info | safe | Address overview: balance, tx count, contract status |
blockscout_get_address_transactions | safe | Paginated transaction history for an address |
blockscout_get_address_token_transfers | safe | ERC-20 token transfer history |
blockscout_get_address_nft_transfers | safe | NFT transfer history |
blockscout_get_address_internal_transactions | safe | Internal (trace-level) transactions |
blockscout_get_address_logs | safe | Event logs emitted by or to an address |
blockscout_get_address_coin_balance_history | safe | Historical native token balance snapshots |
blockscout_get_address_tokens | safe | All ERC-20 tokens held by an address |
blockscout_get_address_nfts | safe | All NFTs held by an address |
| Tool | Risk | Description |
|---|
blockscout_get_transaction | safe | Full transaction details by hash |
blockscout_get_transaction_logs | safe | Event logs for a specific transaction |
blockscout_get_transaction_token_transfers | safe | Token transfers within a transaction |
blockscout_get_transaction_internal_transactions | safe | Internal calls within a transaction |
| Tool | Risk | Description |
|---|
blockscout_get_token_info | safe | Token metadata: name, symbol, decimals, supply |
blockscout_get_token_holders | safe | Top holders for a token |
blockscout_get_token_transfers | safe | Recent transfers for a token contract |
blockscout_search_tokens | safe | Search tokens by name or symbol |
| Tool | Risk | Description |
|---|
blockscout_get_contract_abi | safe | Fetch verified contract ABI |
blockscout_get_contract_source | safe | Fetch verified contract source code |
blockscout_get_contract_read_methods | safe | List readable (view/pure) contract methods |
blockscout_get_contract_write_methods | safe | List writable contract methods |
blockscout_read_contract_method | safe | Call a read method on a verified contract |
| Tool | Risk | Description |
|---|
blockscout_get_block | safe | Block details by number or hash |
blockscout_get_block_transactions | safe | Transactions in a specific block |
blockscout_get_latest_block | safe | Current block number and details |
| Tool | Risk | Description |
|---|
blockscout_get_stats | safe | Chain-level stats: tx count, address count, gas price |
blockscout_get_gas_price_oracle | safe | Current gas price estimates (slow/average/fast) |
EVM
Live on-chain tools using viem. Work on all 17 supported chains.
| Tool | Risk | Description |
|---|
evm_get_balance | safe | Native token balance for any address |
evm_get_token_balance | safe | ERC-20 token balance for any address |
evm_get_transaction | safe | Transaction details by hash (live node) |
evm_get_transaction_receipt | safe | Transaction receipt and status |
evm_call_contract | safe | Call a read-only contract function |
evm_write_contract | financial | Send a transaction to a contract function |
evm_transfer_native | financial | Transfer native ETH/BNB/MATIC |
evm_transfer_token | financial | Transfer ERC-20 tokens |
evm_approve_token | financial | Approve an ERC-20 allowance |
evm_get_allowance | safe | Check current ERC-20 allowance |
evm_estimate_gas | safe | Estimate gas for a transaction |
evm_get_gas_price | safe | Current gas price from the node |
evm_get_block | safe | Block details (live node) |
evm_get_logs | safe | Query event logs with filters |
evm_resolve_ens | safe | Resolve ENS name to address |
evm_lookup_ens | safe | Reverse-resolve address to ENS name |
evm_multicall | safe | Batch multiple read calls in one RPC request |
evm_decode_calldata | safe | Decode transaction calldata using ABI |
evm_encode_calldata | safe | Encode function call to calldata |
evm_get_code | safe | Get bytecode at an address |
evm_get_storage_at | safe | Read a storage slot at an address |
evm_simulate_transaction | safe | Simulate a transaction without broadcasting |
evm_get_nonce | safe | Current nonce for an address |
evm_wait_for_transaction | safe | Wait for a transaction to be mined |
evm_get_chain_id | safe | Current chain ID from the connected node |
evm_deploy_contract | destructive | Deploy a new contract |
evm_sign_message | financial | Sign an arbitrary message with the active wallet |
evm_sign_typed_data | financial | Sign EIP-712 typed data |
evm_get_erc721_owner | safe | Get owner of an NFT token ID |
evm_get_erc721_metadata | safe | Get NFT metadata URI and parsed data |
Tokens
| Tool | Risk | Description |
|---|
resolve_token | safe | Resolve a token symbol or address to full metadata (address, decimals, name) |
list_chain_tokens | safe | List all known tokens for a given chain |
Market
Price, volume, TVL, and sentiment data from DeFiLlama, CoinGecko, and DexScreener.
| Tool | Risk | Description |
|---|
market_get_token_price | safe | Current USD price for one or more tokens |
market_get_token_prices_batch | safe | Batch price lookup for many tokens |
market_get_protocol_tvl | safe | Total value locked for a DeFi protocol |
market_get_chain_tvl | safe | Total TVL across all protocols on a chain |
market_get_top_protocols | safe | Top DeFi protocols ranked by TVL |
market_get_protocol_fees | safe | Protocol fee revenue data |
market_get_protocol_volume | safe | Trading volume for a protocol |
market_get_dex_pairs | safe | DEX trading pairs and liquidity data |
market_get_pair_ohlcv | safe | OHLCV candlestick data for a trading pair |
market_get_trending_tokens | safe | Currently trending tokens by volume or social activity |
market_get_new_pairs | safe | Recently created trading pairs |
market_get_token_info_dexscreener | safe | Token info from DexScreener (price, volume, liquidity) |
market_get_market_overview | safe | High-level market summary (total crypto market cap, dominance) |
market_get_fear_greed_index | safe | Crypto fear and greed index |
market_get_global_defi_stats | safe | Global DeFi statistics |
market_get_stablecoin_data | safe | Stablecoin market data and peg status |
market_get_yield_pools | safe | Yield farming pool data from DeFiLlama |
market_get_bridges_volume | safe | Cross-chain bridge volume statistics |
market_get_token_historical_prices | safe | Historical price data for a token |
market_search_protocols | safe | Search DeFi protocols by name |
Research
Security, governance, and yield research tools.
| Tool | Risk | Description |
|---|
research_get_security_audit | safe | Security audit reports for a protocol |
research_get_token_holders | safe | Top token holders and concentration analysis |
research_get_yield_opportunities | safe | Current yield farming opportunities by chain |
research_get_governance_proposals | safe | Active and recent governance proposals |
research_get_governance_votes | safe | Voting history for a governance proposal |
research_get_protocol_risks | safe | Risk assessment for a DeFi protocol |
research_get_contract_verification | safe | Contract verification status across explorers |
research_get_token_unlocks | safe | Upcoming token unlock schedules |
research_get_liquidations | safe | Recent liquidation events for a protocol |
research_get_whale_activity | safe | Large wallet movements for a token |
Operations
Multi-step operation orchestration for complex flows that span multiple tool calls.
| Tool | Risk | Description |
|---|
operation_prepare | safe | Prepare a multi-step operation (returns steps and state) |
operation_resume | financial | Resume a paused operation at a specific step |
CCXT (CEX)
Centralized exchange tools via the CCXT library. Requires CCXT_CONFIG_PATH with exchange credentials.
| Tool | Risk | Description |
|---|
ccxt_list_exchanges | safe | List all exchanges supported by CCXT |
ccxt_get_exchange_info | safe | Exchange metadata and supported features |
ccxt_get_markets | safe | Available trading pairs on an exchange |
ccxt_get_ticker | safe | Current price and 24h stats for a pair |
ccxt_get_balance | safe | Account balance on a configured exchange |
ccxt_place_order | financial | Place a market or limit order on an exchange |
ACP (Agent Cooperation Protocol)
Tools for the Virtuals Protocol Agent Cooperation Protocol.
| Tool | Risk | Description |
|---|
acp_create_job | financial | Create a new ACP job request |
acp_fund_job | financial | Fund an ACP job with the required payment |
acp_submit_deliverable | financial | Submit a deliverable for an ACP job |
acp_complete_job | financial | Mark an ACP job as complete |
acp_reject_job | financial | Reject a deliverable and trigger dispute |
acp_claim_payment | financial | Claim payment for a completed job |
acp_get_job | safe | Get details of an ACP job |
acp_list_jobs | safe | List ACP jobs for an address |
aGDP (Agent Marketplace)
Tools for the Virtuals Protocol agent GDP marketplace.
| Tool | Risk | Description |
|---|
agdp_hire_agent | financial | Hire an agent from the marketplace |
agdp_get_offerings | safe | List available agent offerings |
agdp_create_offering | financial | Publish a new agent offering |
agdp_get_agent_info | safe | Get details about a marketplace agent |
agdp_list_transactions | safe | List aGDP transaction history |
ERC-8004 (Agent Registry)
On-chain agent identity and reputation tools.
| Tool | Risk | Description |
|---|
erc8004_register_agent | financial | Register an agent on-chain |
erc8004_get_agent | safe | Get agent registration details |
erc8004_update_agent | financial | Update agent metadata |
erc8004_submit_feedback | financial | Submit reputation feedback for an agent |
erc8004_get_feedback | safe | Get reputation feedback for an agent |
X-402 (Payment Protocol)
HTTP-native stablecoin payment tools.
| Tool | Risk | Description |
|---|
x402_check_requirements | safe | Check payment requirements for an X-402 resource |
x402_fetch_with_payment | financial | Fetch an X-402 resource and pay automatically |
Policy
| Tool | Risk | Description |
|---|
policy_get | safe | Get the current treasury policy configuration and spend tracking |
Utility
| Tool | Risk | Description |
|---|
server_status | safe | Health check: loaded integrations, active wallet, chain, version |
list_supported_chains | safe | List all 17 supported chains with IDs and metadata |